home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Jumpstart / Multimedia Microsoft Jumpstart Version 1.1a (Microsoft).BIN / develpmt / drivers / mscdex / testdrv / testdrv.txt < prev    next >
Encoding:
Text File  |  1992-01-25  |  9.0 KB  |  220 lines
  1.     MSCDEX - Microsoft MS-DOS CD-ROM Extensions Version 2.21
  2.                     TESTDRV Test Utility
  3.                               
  4.      TESTDRV is a rigorous test utility for CD-ROM device
  5.      drivers to verify that the drivers adhere to
  6.      specifications. This driver test attempts to fully
  7.      exercise all possible calls to the device driver and
  8.      record the driver's progress.
  9.      
  10. Setup for TESTDRV
  11.  
  12.      TESTDRV assumes that MSCDEX and the appropriate device
  13.      driver are installed. During initialization, TESTDRV
  14.      reads the driver profile from the file TESTDRV.PRO
  15.      which assigns the device status defaults for the test.
  16.      The following example shows a typical TESTDRV.PRO file:
  17.      
  18.      ; This is a sample TESTDRV.PRO
  19.      ; Comments start with ';' and continue to the newline
  20.      DriverName  = MSCD000   ; The driver to test (specified
  21.                              ; as argument to the
  22.                              ; <drivername>.SYS command line
  23.      WriteDevice = f         ; This device is not writable
  24.      Redbook = t             ; This device supports Redbook
  25.                              ; Addressing
  26.      RawMode = t             ; This device supports raw
  27.                              ; mode data
  28.      Prefetch = t            ; This device supports
  29.                              ; prefetching
  30.      AudioControl = t        ; This device supports audio
  31.                              ; channel manipulation
  32.      Audio = t               ; This device supports
  33.                              ; audio/video information
  34.      AudioChannels = 2       ; Number of supported audio
  35.                              ; channels
  36.      Interleave = f          ; This device does not support
  37.                              ; Interleave mode
  38.      InterleaveSize = 0      ; Interleave size (may range
  39.                              ; between 0-255)
  40.      InterleaveSkip = 0      ; Interleave skip (may range
  41.                              ; between 0-255)
  42.      Eject = t               ; This device supports software
  43.                              ; eject requests
  44.      UPC = t                 ; This device implements UPC code
  45.                              ; reading
  46.      Output = HEXDUMP.TXT    ; Output hex dumps to this file.
  47.                              ; Blank assignment sends output
  48.                              ; to stdout
  49.      RedReadSectors = 3:8:3,8:2:4   ; List of sectors to read in
  50.                              ; ReadL tests (Redbook form)
  51.      HSGReadSectors = 0024180c,00ff3421 ; List of sectors to read
  52.                              ; in ReadL tests (HSG form) hex
  53.                              ; only
  54.      ; <EOF>
  55.      
  56.      If the profile variables are not set in the TESTDRV.PRO
  57.      file, they will default to the values shown above
  58.      (except for the sector selections).
  59.      
  60. Running TESTDRV
  61.  
  62.      To run the test simply install your device driver,
  63.      initiate MSCDEX, and execute TESTDRV.EXE. The default
  64.      operation of TESTDRV can be modified through command
  65.      line flags and arguments. Either a hyphen (-) or a
  66.      forward slash (/) denotes the flags. The following
  67.      command line flags and arguments are available:
  68.      
  69.      filename   Alternate driver profile. (default:
  70.                 TESTDRV.PRO)
  71.            
  72.      /A    Attended operation, qualifying interactive
  73.            tests. (default: unattended operation)
  74.            
  75.      /I    Override disk recognition on control disk. That
  76.            is, behave as if the disk is unknown even if 
  77.            it is a member of the Test Set.
  78.            (default: if recognized, several data matching
  79.            tests are qualified).
  80.            
  81.      /T    Terse output, no hex dumps and fewer diagnostic
  82.            messages.
  83.            
  84.      /[#]  Where # is a digit between 0 and 7, the drive
  85.            number.
  86.            
  87.      In unattended (default) mode, all tests will be
  88.      verified by both successful completion, given an
  89.      acceptable request, and successful error recovery,
  90.      given an unacceptable request. The output has the
  91.      following format:
  92.      
  93.      [Command Code.Subcommand Code]   [Status]
  94.      [Command[:Subcommand]]:[Test Comment]
  95.      
  96.      For example, the test for the location of the driver
  97.      head may return:
  98.      
  99.        3:12 TESTING  IOCTLI: QInfor:    BUSY:DONE:
  100.        3:1  TESTING  IOCTLI:LocHead:    BUSY:DONE:
  101.          #1 Qinfo: Cntrl 1, Track 19, P/Index 1, Track
  102.        Running Time 0:0:0
  103.        Disk running time: 47:35:0
  104.        Location of Head 47:35:0
  105.        
  106.      Commands that return sector data or device dependent
  107.      data will dump output in hexadecimal. If the disk is a
  108.      recognized test disk and recognition is turned on
  109.      (default), sector data will be compared to correct
  110.      values and only the status returned.
  111.      
  112. Attended and Unattended Operation
  113.  
  114.      Several calls to the driver cause or report physical
  115.      changes in the drive unit or require that audio disk
  116.      information be played through audio channels like
  117.      conventional audio CD players. These states should be
  118.      confirmed by an operator. A series of YES/NO queries
  119.      and simple directions allow the operator to quickly
  120.      step through these tests. In order to allow for
  121.      operator-free testing, a set of alternate best-guess
  122.      tests can be executed instead of the ones that require
  123.      confirmation. Attended testing is a super-set of
  124.      unattended testing and should be considered the most
  125.      complete run of the test program.
  126.      
  127.      For example, the following sequence occurs in the
  128.      attended mode:
  129.      
  130.        132   TESTING     PlayReq:   BUSY:DONE:
  131.        Playing track from 47:35:0
  132.                 Can you hear music playing? [Yncq]_
  133.        132      PlayReq: Request Completed Successfully.
  134.        
  135.      For a successful sequence, music would play and the
  136.      tester would respond with 'Y'.
  137.      
  138. Control Disk Verification
  139.  
  140.      The test for verifying read data requires the Microsoft
  141.      Bookshelf and Microsoft Programmer's Library to be used
  142.      as control disks. The test procedure reads data from
  143.      the control disks then compares both raw and cooked
  144.      data for correspondence with archived data. If the test
  145.      is run without the control disks, the data read is
  146.      dumped in hexadecimal and ASCII format to the specified
  147.      output.
  148.      
  149. Nonstandard CD-ROM Features
  150.  
  151.      Several driver commands derive their results or actions
  152.      from hardware dependent features of the driver. Since
  153.      not all drivers can be supported in a general release,
  154.      special features of a device driver may not be
  155.      adequately tested. (For example, write commands apply
  156.      to few CD-ROM drives and are only minimally supported
  157.      by error recovery tests.) If the hardware dependent CD-
  158.      ROM device driver document describes the results of a
  159.      driver request as undefined, the request will be tested
  160.      for simple completion and error recovery. Requests that
  161.      return data will dump the data to the selected output
  162.      in hexadecimal and readable ASCII format.
  163.      
  164. Other Tests For CD-ROM Drives
  165.  
  166.      CD-ROM drives are a natural companion to multimedia
  167.      applications. The performance of many multimedia
  168.      applications is dependent on the rate that data is
  169.      streamed from the CD-ROM. You can use the CDSPEED
  170.      program described in the next chapter to test the data
  171.      rate of CD-ROM drives.
  172.      
  173.      As the user base and popularity of the Multimedia
  174.      Extensions to Windows expands, the demand for
  175.      compatible CD-ROM drives will increase. The MUSICBOX
  176.      application provided with Windows with Multimedia 1.0
  177.      provides a good platform to test the operation of you
  178.      CD-ROM drive and driver. In addition to identifying
  179.      incompatible behavior between a CD-ROM driver and
  180.      MUSICBOX, the following tests help verify that the CD-
  181.      ROM drive can properly play Redbook audio.
  182.      
  183.     1. Load Windows with Multimedia 1.0 on your system.
  184.  
  185.     2. Start Windows.
  186.  
  187.     3. If necessary, remove the disc from the CD-ROM drive.
  188.  
  189.     4. Start MUSICBOX and observe the operation of the
  190.        system.
  191.  
  192.        Some drivers hang the system for a minute or more
  193.        when MUSICBOX is started. The delay should be no more
  194.        than a few seconds.
  195.     
  196.     5. Put an audio CD in the CD-ROM drive with MUSICBOX
  197.        going.
  198.     
  199.     6. Seek to the next track with MUSICBOX and observe
  200.        operation.
  201.  
  202.        Some drivers do not support seek. Other drivers seek
  203.        when playing but not when its stopped. Others seek
  204.        when stopped but not when playing. Users expect the
  205.        CD-ROM drive to seek when they are playing audio CDs.
  206.  
  207.     7. Put MUSICBOX on repeat and make sure it repeats. Some
  208.        drivers do not repeat.
  209.  
  210.     8. Check that the status (time, track) is accurate.
  211.  
  212.        Some drivers pass inaccurate information back to
  213.        MUSICBOX.
  214.  
  215.     9. Play to the end of the CD and let it stop.
  216.  
  217.        Some drivers fail when they play to the end of a CD.
  218.     
  219.     
  220.